如何列举Bucket的所有文件、指定前缀的文件、指定目录下的文件和子目录？

仅Python SDK 2.12.0及以上版本支持使用GetBucketV2（ListObjectsV2）方法。

本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见访问域名和数据中心。

本文以从环境变量读取访问凭证为例。如何配置访问凭证，请参见配置访问凭证。

本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient，请参见初始化。

要列举文件，您必须有oss:ListObjects权限。具体操作，请参见为RAM用户授权自定义的权限策略。

您可以调用GetBucket（ListObjects)）或GetBucketV2（ListObjectsV2）接口，一次性列举某个Bucket下最多1000个Object。您可以通过指定参数实现多种列举功能，例如通过指定参数列举指定起始位置后的所有文件、列举指定目录下的文件和子目录、以及列举结果分页。这两个接口的主要区别如下：

使用GetBucket（ListObjects）接口列举文件时，默认返回owner信息。

使用GetBucketV2（ListObjectsV2）接口列举文件时，需通过fetchOwner指定是否在返回结果中包含owner信息。

对于开启版本控制的Bucket，建议使用GetBucketV2（ListObjectsV2）接口列举文件。

以下分别介绍通过GetBucket（ListObjects）以及GetBucketV2（ListObjectsV2）方法列举文件时涉及的参数说明。

GetBucket（ListObjects）涉及参数说明如下：

参数

描述

prefix

本次查询结果的前缀。

delimiter

对文件名称进行分组的字符。

marker

此次列举文件的起点。

GetBucketV2（ListObjectsV2）涉及参数说明如下：

参数

描述

prefix

本次查询结果的前缀。

delimiter

对文件名称进行分组的字符。

startAfter

此次列举文件的起点。

fetchOwner

指定是否在返回结果中包含owner信息。

true：表示返回结果中包含owner信息。

false：表示返回结果中不包含owner信息。

通过GetBucket（ListObjects）方法列举指定存储空间下的10个文件的示例代码如下。

ObjectIterator封装了ListObjects接口，以迭代器的方式提供，方便您使用。

通过GetBucketV2（ListObjectsV2）方法列举指定存储空间下的10个文件的示例代码如下。

ObjectIteratorV2封装了ListObjectsV2接口，以迭代器的方式提供，方便您使用。

通过GetBucket（ListObjects）方法列举指定存储空间下所有文件的示例代码如下。

仅列举文件，不返回文件的owner信息

通过GetBucketV2（ListObjectsV2）方法列举指定存储空间下所有文件的示例代码如下。

列举文件，并返回文件的owner信息

通过GetBucketV2（ListObjectsV2）方法列举指定存储空间下所有文件，并通过指定fetch_owner参数返回文件的owner信息的完整示例代码如下。

假设存储空间中有4个文件： oss.jpg、fun/test.jpg、fun/movie/001.avi、fun/movie/007.avi，正斜线（/）作为文件夹的分隔符。

通过GetBucket（ListObjects）方法列举指定前缀的所有文件的示例代码如下。

通过GetBucketV2（ListObjectsV2）方法列举指定前缀的所有文件的示例代码如下。

通过设置marker参数可以指定列举的起始位置，OSS将会返回字符串marker的字典序后的所有文件。假设存储空间中包含4个文件，分别为x1.txt、x2.txt、z1.txt和z2.txt。

通过GetBucket（ListObjects）方法列举指定起始位置后的所有文件的示例代码如下。

通过设置start_after参数可以指定列举的起始位置，OSS将会返回字符串start_after的字典序后的所有文件。假设存储空间中包含4个文件，分别为x1.txt、x2.txt、z1.txt和z2.txt。

通过GetBucketV2（ListObjectsV2）方法列举指定起始位置后的所有文件的示例代码如下。

OSS没有文件夹的概念，所有元素都是以文件来存储。创建文件夹本质上来说是创建了一个大小为0并以正斜线（/）结尾的文件。这个文件可以被上传和下载，控制台会对以正斜线（/）结尾的文件以文件夹的方式展示。

通过delimiter和prefix两个参数可以模拟文件夹功能：

如果设置prefix为某个文件夹名称，则会列举以此prefix开头的文件，即该文件夹下所有的文件和子文件夹（目录）。

如果再设置delimiter为正斜线（/），则只列举该文件夹下的文件和子文件夹（目录）名称，子文件夹下的文件和文件夹不显示。

通过GetBucket（ListObjects）方法列举指定目录下的文件和子目录的示例代码如下。

通过GetBucketV2（ListObjectsV2）方法列举指定目录下的文件和子目录的示例代码如下。

通过GetBucket（ListObjects）方法列举指定目录下的文件大小的示例代码如下。

通过GetBucketV2（ListObjectsV2）方法列举指定目录下的文件大小的示例代码如下。

关于列举文件的完整示例代码，请参见GitHub示例。

关于列举文件的API接口说明，请参见GetBucket (ListObjects)和ListObjectsV2（GetBucketV2）。